home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / xmore103.zip / XMORE.DOC < prev    next >
Text File  |  1993-05-18  |  6KB  |  146 lines
  1.  
  2. XMORE v01.03.00     (18 MAY 1993)
  3.  
  4. Copyright (c) 1993, Professional Software Engineering
  5. All rights reserved.
  6.  
  7.  
  8. XMORE is a simple utility to allow you to use Vern Buerg's LIST program (the 
  9. finest text file view utility you can get, in my opinion) to view piped 
  10. (redirected) material, like so:
  11.  
  12.     DIR|XMORE
  13.  
  14. would do a directory, and view it in LIST.
  15.  
  16. DIR is not what I'd normally use XMORE for though.  I am a programmer, so I 
  17. use a number of tools, including string search utilities which run from the 
  18. DOS commandline, like so:
  19.  
  20.     FGREP -i "Function"|XMORE
  21.  
  22. This will allow me to view the results (often quite lengthly) of the string 
  23. search.
  24.  
  25. To view an existing file:
  26.  
  27.     XMORE < filename
  28.  
  29. XMORE coupled with LIST basically gives you a fully scrollable (and 
  30. searchable) MORE with me all of the file manipulation capabilities of LIST: 
  31. search, copy to file, print, edit (though you'd better save it to a different 
  32. filename), view in Hex, etc.
  33.  
  34. Since XMORE is pretty much a drop-in replacement for the DOS MORE command, it 
  35. does not accept any commandline parameters.  Using commandline parameters 
  36. will simply bring up help.
  37.  
  38. There are two different XMORE executables included:
  39. XMORE.EXE    can run only .COM & .EXE programs
  40. XMORE_B.EXE    can run .BAT .COM or .EXE programs
  41.  
  42. Choose which you want to use, and rename it to XMORE (or whatever -- the 
  43. utility can be renamed to MORE as well without problems).  XMORE_B is a bit 
  44. slower since it must run a copy of your command processor (usually 
  45. COMMAND.COM, but whatever is specified by the environment variable COMSPEC 
  46. will be used) before running the viewing program -- but it is capable of 
  47. running .BAT files.  Since I personally use LIST (a .COM program) with XMORE, 
  48. I prefer the slightly speedier COM/EXE only version.
  49.  
  50.  
  51. XMORE requires an external program to do the file viewing.  By default, it 
  52. looks to run LIST (LIST.COM or LIST.EXE, and if running XMORE_B, LIST.BAT).  
  53. The restriction is that the program accept a single commandline parameter -- 
  54. a filename.
  55.  
  56. There is an environment variable that the program can use if you set it 
  57. called XMORE.  Reguardless of what you might rename the XMORE program to, the 
  58. environment variable will remain XMORE.
  59.  
  60.     SET XMORE=program_to_use
  61.  
  62. So, to launch the MS-DOS EDITOR (included with v5.00 and later), you could 
  63. use:
  64.  
  65.     SET XMORE=EDIT
  66.  
  67. or even:
  68.     SET XMORE=C:\DOS\EDIT.COM
  69.  
  70. if you wanted to specify the one and only program to run (if an entire path 
  71. is specified, the path will not be searched for another program by the same 
  72. filename).
  73.  
  74. XMORE, of course simply defaults to "LIST".
  75.  
  76.  
  77. I don't warrant the program to work with anything but the intended LIST 
  78. program by Vern Buerg, but I don't see any potential problems with it running 
  79. with other programs (I have tested it with a variety of programs).
  80.  
  81.  
  82. In short, if you use DOS MORE frequently, you might consider using XMORE.  Or 
  83. if you ever redirect output to a file, launch a file viewer on that file, and 
  84. then delete the file when you are done, XMORE is the utility for you.
  85.  
  86. XMORE requires enough disk space to make a disk file with the redirected 
  87. information in it -- due to internal differences between one version of DOS 
  88. and the next, I decided not to have it try to locate the original filename of 
  89. the temporary file which DOS creates when redirecting output (a tricky task).  
  90. XMORE will create the temporary file in the directory specified by the 
  91. "XMOREDIR", "TEMP", "TMP", or "TMPDIR" environment variables (it uses the 
  92. first environment variable found, in that order), or the root directory of 
  93. the current drive.
  94.  
  95.  
  96. Here's legal in your eyes:
  97. This program must be distributed unmodified and in it's entirety (program
  98. and this documentation).  No files may be added to the archive (such as BBS
  99. advertisements), ZIP (or other archive format) headers permitting, provided
  100. that they do not claim ownership of the material.  It is not to be bundled
  101. with other software, Commercial, Shareware, Freeware, or otherwise.
  102. So-called "shareware" disk distribution sites must contact me for approval
  103. before distributing this software if they charge in excess of $3.95 per disk.
  104.  
  105. Failure to comply with these requirements will subject you to prosecution to
  106. the full extent provided by U.S. Copyright Law, including provisions from the 
  107. Berne Convention.
  108.  
  109.  
  110. The standard disclaimer applies:
  111. This program works for me within the (actually quite complex) environment in 
  112. which I use it.  I make no warranty that it will work in all environments or 
  113. on all hardware platforms.  I cannot be held responsible for any damages which 
  114. may result from it's use.  By using this software, you agree to hold Sean 
  115. Straw / Professional Software Engineering clear of any liability for damages, 
  116. including but not limited to, lost data, damaged hardware, and loss of income.
  117.  
  118. Your mileage may vary.  Void where prohibited.
  119.  
  120. However, should you encounter problems with this program, I would like to
  121. hear about them so that I may attempt to correct the problems (time and
  122. equipment permitting).
  123.  
  124.  
  125. This program is Shareware.  I don't ask much for it -- a paltry US $5.00.
  126. And that if you use LIST that you register it (with it's author).
  127.  
  128. I am in no way associated with Vern Buerg.  My mentioning of him and his 
  129. utility should not be construed as an endorsement of his product, nor as an 
  130. endorsement by him of mine.  With any luck, he may build a similar capability 
  131. directly into his program.
  132.  
  133.  
  134. Send registrations to:
  135.  
  136. Sean Straw
  137. Professional Software Engineering
  138. Post Box 2395
  139. San Rafael, CA  94912-2395
  140.  
  141. Please be sure to state "Registration for XMORE", and the version number when 
  142. registering.
  143.  
  144. A $15.00 service charge will be levied on returned cheques.
  145.  
  146.